ICEnroll::p ut_SPCFileName メソッド (xenroll.h)

[このプロパティは、Windows Server 2008 および Windows Vista では使用できなくなりました。

SPCFileName プロパティは、証明機関から返された base64 でエンコードされた PKCS #7 (BSTR 形式) を書き込むファイルの名前を設定または取得します。

このプロパティは、 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
Library	Uuid.lib
[DLL]	Xenroll.dll