IDot11AdHocNetwork::GetSignature method (adhoc.h)

  • Article

Gets the unique signature associated with the ad hoc network. The signature uniquely identifies an IDot11AdHocNetwork object with a particular set of attributes.

Syntax

HRESULT GetSignature(
  [in, out] GUID *pSignature
);

Parameters

[in, out] pSignature

A signature that uniquely identifies an ad hoc network. This signature is generated from certain network attributes.

Return value

Possible return values include, but are not limited to, the following.

Return code Description
S_OK
 The method completed successfully.
E_FAIL
 The method failed.
E_INVALIDARG
 One of the parameters is invalid.
E_OUTOFMEMORY
 The method could not allocate the memory required to perform this operation.
E_POINTER
 A pointer passed as a parameter is not valid.

Remarks

Do not cache the returned signature locally. Whenever a network object changes, its signature changes. Actions that are not associated with notifications, such as saving the network's profile, can cause the signature to change.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header adhoc.h

See also

IDot11AdHocNetwork