共用方式為

ICertServerExit：：GetRequestAttribute 方法 (certif.h)

  • 發行項

GetRequestAttribute 方法會從要求傳回具名屬性值。

呼叫此方法之前，必須呼叫 ICertServerExit：：SetContext。

語法

HRESULT GetRequestAttribute(
  [in]  const BSTR strAttributeName,
  [out] BSTR       *pstrAttributeValue
);

參數

[in] strAttributeName

要擷取之屬性的名稱。

[out] pstrAttributeValue

將包含屬性值的 BSTR 值的指標。

傳回值

C++

如果方法成功，方法會傳回S_OK，而 *pstrAttributeValue 會設定為包含屬性值的 BSTR 。

若要使用此方法，請建立 BSTR 類型的變數、將變數設定為 NULL，並將此變數的位址傳遞為 pstrAttributeValue。

當您完成 使用 BSTR 時，請藉由呼叫 SysFreeString 函式 來釋放它。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

VB

傳回值是代表屬性值的字串。

備註

您必須在使用此方法之前呼叫 ICertServerExit：：SetContext 。

下列要求屬性對 KEYGEN 樣式要求而言是唯一的。

屬性名稱 類型 Description
挑戰 字串 要求隨附的挑戰字串。
ExpectedChallenge 字串 如果挑戰字串不正確，則伺服器會將這個要求屬性的值設定為預期的挑戰，以便診斷失敗。
 

範例

BSTR       bstrAttribValue = NULL;
HRESULT    hr;

// Get the request attribute.
// bstrAttribName is a BSTR assigned by EnumerateAttributes.
// Also, ICertServerExit::SetContext has already been
// called by pCertServerExit.
hr = pCertServerExit->GetRequestAttribute(bstrAttribName,
                                          &bstrAttribValue);

if (FAILED(hr))
{
    printf("Failed GetRequestAttribute [%x]\n", hr);
    goto error;
}
else
{

    // Successful call. Use bstrAttribValue as needed.
    // ...
}

// Done processing. Free BSTR.
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 certif.h (包括 Certsrv.h)
程式庫 Certidl.lib
Dll Certcli.dll

另請參閱

ICertServerExit

ICertServerExit：：SetContext