IEnroll4::getCertContextFromFileResponseWStr method

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The getCertContextFromFileResponseWStr method retrieves the certificate from a file containing a response from a certification authority. This method was first defined in the IEnroll4 interface.

Syntax


HRESULT getCertContextFromFileResponseWStr(
  [in]  LPCWSTR        pwszResponseFileName,
  [out] PCCERT_CONTEXT *ppCertContext
);

Parameters

pwszResponseFileName [in]

A pointer to a null-terminated wide character string that represents the name of the file containing the response.

ppCertContext [out]

A pointer to a pointer to a CERT_CONTEXT structure that receives the certificate retrieved from the response.

Remarks

The response contained in pwszResponseFileName must contain exactly one certificate; a child certificate cannot be present.

The response may be either a PKCS #7 or a full Certificate Management over CMS (CMC) response. However, to accept a full CMC response, the cryptographic service provider must support Abstract Syntax Notation One (ASN.1) encoding of CMC structures.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_IEnroll4 is defined as f8053fe5-78f4-448f-a0db-41d61b73446b

See also

IEnroll4

 

 

Show: