3.9.4.5 EnumerateApplicationsInPool (Opnum 7)

  • Article

The EnumerateApplicationsInPool method returns the metabase paths for the applications associated with the application pool.

 HRESULT EnumerateApplicationsInPool(
   [in, unique, string] LPCWSTR szPool,
   [out] BSTR* bstrBuffer
 );

szPool: A pointer to a Unicode string that contains the name of the application pool to enumerate.

bstrBuffer: A pointer to a BSTR that receives the application metabase paths. The BSTR contains a sequence of contiguous null-terminated strings. The buffer is terminated by another null character. The server allocates storage, and the client is responsible for freeing the storage with SysFreeString; see [MS-OAUT].

Return Values:  A signed 32-bit value that indicates return status. If the method returns a negative value, it failed. If the 12-bit facility code (bits 16–27) is set to 0x007, the value contains a Win32 error code in the lower 16 bits. Zero or positive values indicate success, with the lower 16 bits in positive nonzero values containing warnings or flags defined in the method implementation. For more information about Win32 error codes and HRESULT values, see [MS-ERREF].

Return value/code

Description

0x00000000

S_OK

The call was successful.

The opnum field value for this method is 7.

When processing this call, the server MUST do the following:

  • Determine the metabase paths of all applications associated with the application pool specified by the szPool parameter. The paths are returned as contiguous, null-terminated strings in the bstrBuffer parameter.