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

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

ProviderName プロパティは、使用する暗号化サービス プロバイダー (CSP) の名前を設定または取得します。

CSP が指定されていない場合、このプロパティの既定値は "Microsoft Base Cryptographic Provider" であり、 ProviderName プロパティは空の文字列に設定されます。 このプロパティは、 ICEnroll インターフェイスで最初に定義されました。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT put_ProviderName(
  BSTR bstrProvider
);

パラメーター

bstrProvider

戻り値

なし

解説

ProviderName プロパティは、次のメソッドの動作に影響します。

• createPKCS10
• createFilePKCS10
• enumContainers

例

BSTR     bstrProvName = NULL;
BSTR     bstrMyProvName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

// set the ProviderName value
bstrMyProvName = SysAllocString(TEXT("Microsoft Base DSS")
                                TEXT(" Cryptographic Provider"));
hr = pEnroll->put_ProviderName( bstrMyProvName );
if (FAILED( hr ))
    printf("Failed put_ProviderName - %x\n", hr );
else
    printf( "ProviderName set to %ws\n", bstrMyProvName );
// free BSTR when done
if ( NULL != bstrMyProvName )
    SysFreeString( bstrMyProvName );

要件