ISynchronizeHandle::GetHandle method (objidl.h)

Article
02/22/2024

Retrieves a handle to the synchronization object.

Syntax

HRESULT GetHandle(
  [out] HANDLE *ph
);

Parameters

[out] ph

A pointer to the variable that receives a handle to the synchronization object.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_FAIL, and S_OK.

Remarks

Do not close the handle returned in the ph parameter. The lifetime of the handle is controlled by the object that implements the ISynchronizeHandle interface.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	objidl.h (include ObjIdl.h)