Edit

Share via

IPxeAuthClass::ReadIdentity Method

  • Article

In Configuration Manager, the ReadIdentity method reads a PXE certificate identity from the client configuration (PFX) file. The method is used in serializing a certificate from the file.

Syntax

HRESULT ReadIdentity(  
   BSTR FileName,  
   BSTR FilePassword,  
   BSTR SMSID,  
   VARIANT* Identity  
);

Parameters

FileName
Data type: BSTR

Qualifiers: [in]

Name of the client configuration (PFX) file.

FilePassword
Data type: BSTR

Qualifiers: [in]

Password to use for access to the client configuration file.

SMSID
Data type: BSTR

Qualifiers: [in]

The GUID used to identify the certificate. This is the value of the SMSID property in SMS_CertificateInfo Server WMI Class.

Identity
Data type: VARIANT

Qualifiers: [out, retval]

PXE certificate identity. The return value can be used with SubmitRegistrationRecord Method in Class SMS_Site.

Return Values

An HRESULT code. Possible values include, but are not limited to, the following value.

S_OK
The method succeeded.

Remarks

See Also

IPxeAuthClass Interface
About Operating System Deployment Site Role Configuration