Share via

3.1.4.6.1 IWbemFetchSmartEnum::GetSmartEnum (Opnum 3)

  • Article

The IWbemFetchSmartEnum::GetSmartEnum method retrieves an IWbemWCOSmartEnum (section 3.1.4.7) interface, which is a network-optimized enumerator interface.

 HRESULT GetSmartEnum(
   [out] IWbemWCOSmartEnum** ppSmartEnum
 );

ppSmartEnum: MUST be a pointer to a network-optimized enumerator interface. This parameter MUST NOT be NULL. Upon return by the server, this parameter can be NULL if there is a failure or if there are no results.

Return Values: This method MUST return an HRESULT value that MUST indicate the status of the method call. The server MUST return WBEM_S_NO_ERROR (specified in section 2.2.11) to indicate the successful completion of the method.

WBEM_S_NO_ERROR (0x00)

The server MUST locate the associated IEnumWbemClassObject interface pointer in the EnumWbemClassObjectTable, and validate that the security principal that makes the call is the same as the ClientSecurityContext of the SemiSinkResultSetObject pointed to by the entry in the EnumWbemClassObjectTable; otherwise, WBEM_E_ACCESS_DENIED MUST be returned.

In response to the IWbemFetchSmartEnum::GetSmartEnum method, the server MUST return an IWbemWCOSmartEnum interface in the ppSmartEnum output parameter.

A successful execution MUST return the IWbemWCOSmartEnum interface in the output parameter and MUST return WBEM_S_NO_ERROR.

The failed method execution MUST set the output parameters to NULL and MUST return an error in the format specified in section 2.2.11.