Edit

Share via

INapCertRelyingParty::SubscribeCertByGroup method

  • Article

Note

The Network Access Protection platform is not available starting with Windows 10

The SubscribeCertByGroup method subscribes to a health certificate server (HCS). The HCS must already be registered before subscribing.

Syntax

HRESULT SubscribeCertByGroup(
  [in]        EnforcementEntityId  id,
  [in]  const BSTR                subscriberName,
  [in]  const  VARIANT            *reserved,
  [out]       BOOL                *certExists
);

Parameters

id [in]

An EnforcementEntityId that contains the ID of the enforcement client that is subscribing.

subscriberName [in]

The name of the subscriber.

Note

This is currently only used for logging purposes.

reserved [in]

Must be NULL.

certExists [out]

Indicates whether a health certificate from this HCS is already being maintained by the NapAgent and is present in the machine store. If TRUE, a health certificate is already being maintained and is present. If FALSE, a health certificate is not currently being maintained and present.

Return value

Returns one of the following error codes based on the result of this operation.

Return code Description
S_OK
The operation is successful.
E_ACCESSDENIED
Permissions error, access denied.
E_OUTOFMEMORY
System resource limit, could not perform the operation.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]
Header
NapCertRelyingParty.h
IDL
NapCertRelyingParty.idl

See also

INapCertRelyingParty