IPxeAuthClass::ReadIdentity Method

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

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: 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

Concepts

IPxeAuthClass Interface
About Operating System Deployment Site Role Configuration
How to Serialize a Certificate from a PFX File