3.3.4.3.5 RpcEnumAddFilter (Opnum 4)

  • Article

The RpcEnumAddFilter method adds another filter to the current enumeration. This method MUST be called after RpcOpenEnum and before RpcGetEnumResult or RpcGetEnumResultEx. No special permissions are required to call this method.

 HRESULT RpcEnumAddFilter(
   [in] ENUM_HANDLE hEnum,
   [in] ENUM_HANDLE hSubEnum
 );

hEnum:  The handle to the session enumeration object. This is of type ENUM_HANDLE.

hSubEnum:  The handle to another enumeration whose filter will be applied to the current enumeration. The other enumeration MUST be created using RpcOpenEnum and any combination of RpcFilterByState, RpcFilterByCallersName, and RpcFilterBySessionType.

Return Values:  The method MUST return S_OK (0x00000000) on success; otherwise, it MUST return an implementation-specific negative value.

Return value/code

Description

0x00000000

S_OK

Successful completion.