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.

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

Parameters

FileName

Data type: BSTRQualifiers: [in]Name of the client configuration (PFX) file.
FilePassword

Data type: BSTRQualifiers: [in]Password to use for access to the client configuration file.
SMSID

Data type: BSTRQualifiers: [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: VARIANTQualifiers: [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

How to Serialize a Certificate from a PFX File

Concepts

IPxeAuthClass Interface
About Operating System Deployment Site Role Configuration