ICEnroll：:p ut_SPCFileName 方法 (xenroll.h)

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

SPCFileName屬性會設定或擷取檔案名，以BSTR) 形式寫入 base64 編碼 PKCS #7 (，如憑證授權單位單位傳回。

此屬性最初是在 ICEnroll 介面中定義。

這是可讀寫的屬性。

語法

HRESULT put_SPCFileName(
  BSTR bstr
);

參數

bstr

傳回值

無

備註

檔案會寫入為二進位 PKCS #7。 指定此檔案不會影響將憑證接受至任何使用者的存放區。

如果檔案已經存在，系統會通知使用者，並提示使用者取得覆寫許可權。

SPCFileName 會影響下列方法的行為：

• acceptPKCS7
• acceptFilePKCS7

範例

BSTR     bstrSPCFile = NULL;
BSTR     bstrNewSPCFile = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the SPCFileName
hr = pEnroll->get_SPCFileName( &bstrSPCFile );
if (FAILED( hr ))
    printf("Failed get_SPCFileName - %x\n", hr );
else
    printf( "SPCFileName: %ws\n", bstrSPCFile );
// free BSTR when done
if ( NULL != bstrSPCFile )
    SysFreeString( bstrSPCFile );

// set the SPCFileName, for example, "MyFile.SPC".
bstrNewSPCFile = SysAllocString(TEXT("<FILENAMEHERE>"));

hr = pEnroll->put_SPCFileName( bstrNewSPCFile );
if (FAILED( hr ))
    printf("Failed put_SPCFileName - %x\n", hr );
else
    printf( "SPCFileName set to %ws\n", bstrNewSPCFile );
// free BSTR when done
if ( NULL != bstrNewSPCFile )
    SysFreeString( bstrNewSPCFile );

規格需求

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