Método ICEnroll::get_ProviderName (xenroll.h)

[Essa propriedade não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

A propriedade ProviderName define ou recupera o nome do provedor de serviços criptográficos (CSP) a ser usado.

Se o CSP não tiver sido especificado, o valor padrão dessa propriedade será "Provedor criptográfico base da Microsoft" e a propriedade ProviderName será definida como uma cadeia de caracteres vazia. Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_ProviderName(
  BSTR *pbstrProvider
);

Parâmetros

pbstrProvider

Valor retornado

Nenhum

Comentários

A propriedade ProviderName afeta o comportamento dos seguintes métodos:

• createPKCS10
• createFilePKCS10
• enumContainers

Exemplos

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 );

Requisitos