3.1.4.1.8 PerflibV2CloseQueryHandle (Opnum 4)

The PerflibV2CloseQueryHandle method closes the handle that is returned from the PerflibV2OpenQueryHandle method.

 error_status_t PerflibV2CloseQueryHandle(
   [in, out] PRPC_HQUERY phQuery
 );

phQuery: A handle that is created by the PerflibV2OpenQueryHandle method. An exception is thrown or an error is returned by RPC if the handle did not originate from the PerflibV2OpenQueryHandle method. On method return, phQuery MUST be set to NULL.

Return Values: This method MUST return zero (ERROR_SUCCESS) for success; otherwise, it MUST return one of the standard Windows errors, as specified in [MS-ERREF] section 2.2.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The return value indicates success.

0x00000005

ERROR_ACCESS_DENIED

The server returns this value to the client if the authentication level of the client is less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY. The opened handle, phQuery, remains in that state until the client calls PerflibV2CloseQueryHandle with authentication level RPC_C_AUTHN_LEVEL_PKT_PRIVACY.