IXpsSignatureRequest：：GetRequestId 方法 (xpsdigitalsignature.h)
取得簽章要求的唯一標識碼。
語法
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
參數
[out, retval] requestId
簽章要求的唯一標識碼。
傳回值
方法會傳回 HRESULT。 可能的值包括下列數據表中的值，但不限於這些值。 如需此表格中未列出的傳回值，請參閱 XPS 數位簽名 API 錯誤 和 XPS 檔錯誤。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
requestId 為 NULL。 |
|
介面未連線到簽章管理員。 |
備註
這個方法會配置 requestId 中傳回之字串所使用的記憶體。 如果 requestId 不是 NULL，請使用 CoTaskMemFree 函式來釋放記憶體。
requestId 參數會接收 SignatureDefinition 元素的 SpotID 屬性值。 需要 SpotID 屬性，而且應該遵循 xs：ID (XML 識別子) 格式;不過，不會檢查現有的 SignatureDefinitions 元件是否符合建議的格式。 某些由 WPF Windows Presentation Foundation (產生的 XPS 檔，) 應用程式可能會有以數位開頭的識別碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | xpsdigitalsignature.h |