Share via


ICEnroll::get_WriteCertToCSP 方法 (xenroll.h)

[自 Windows Server 2008 和 Windows Vista 起,這個屬性已不再可供使用。]

WriteCertToCSP 屬性會設定或擷取布爾值,判斷憑證是否應該寫入密碼編譯服務提供者 (CSP) 。

此屬性最初是由 ICEnroll 介面所定義。

這是可讀寫的屬性。

語法

HRESULT get_WriteCertToCSP(
  BOOL *fBool
);

參數

fBool

傳回值

備註

這個屬性通常會與智慧卡搭配使用,其中除了寫入 「MY」 存放區之外,還會將憑證寫入智慧卡。

默認值為 true,這表示憑證註冊控制會嘗試將憑證寫入 CSP,但除非遇到硬體令牌錯誤,否則不會失敗。 如果此值 為 true,但未安裝任何智慧卡或其他硬體相依 CSP,則會忽略硬體令牌錯誤。

若要明確強制憑證註冊控制不會嘗試寫入 CSP,請將此值設定為 false。

WriteCertToCSP 會影響下列方法的行為:

範例

BOOL     bWriteCSP;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the WriteCertToCSP value
hr = pEnroll->get_WriteCertToCSP( &bWriteCSP );
if (FAILED( hr ))
    printf("Failed get_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP: %d\n", bWriteCSP );

// set the WriteCertToCSP value
hr = pEnroll->put_WriteCertToCSP( TRUE );
if (FAILED( hr ))
    printf("Failed put_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP set to TRUE\n" );

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 xenroll.h
程式庫 Uuid.lib
Dll Xenroll.dll