ICertRequest3::GetRequestId method

The GetRequestId method gets the current internal request number for the request and subsequent certificate.

This can be used to reference a request unambiguously to a server administrator or other interface.

Syntax


HRESULT GetRequestId(
  [out] LONG *pRequestId
);

Parameters

pRequestId [out]

A pointer to the request ID value.

Return value

C++

If the method succeeds, the method returns S_OK.

Upon successful completion of this function, *pRequestId is set to the value of the request ID.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

The return value specifies the current internal request number for the request and subsequent certificate.

Examples


long    nReqID;
// pCertRequest is previously instantiated ICertRequest
// object pointer. Retrieve the request ID for the previous request.
hr = pCertRequest->GetRequestId(&nReqID);
if (FAILED(hr))
{
    printf("Failed GetRequestId [%x]\n", hr);
    goto error;
}
else
{
    // Use the request ID as needed...
}

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certcli.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certcli.dll

IID

IID_ICertRequest3 is defined as AFC8F92B-33A2-4861-BF36-2933B7CD67B3

See also

ICertRequest3
ICertRequest2
ICertRequest
CCertRequest

 

 

Show: