Método ICspInformation::InitializeFromName (certenroll.h)

O método InitializeFromName inicializa o objeto de uma cadeia de caracteres que contém um nome de provedor. Esse método está habilitado para a Web.

Sintaxe

HRESULT InitializeFromName(
  [in] BSTR strName
);

Parâmetros

[in] strName

Uma variável BSTR que contém o nome.

Retornar valor

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado	Descrição
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	O objeto já está inicializado.

Comentários

O método InitializeFromName abre o provedor nomeado e o consulta para definir os seguintes valores de propriedade no objeto ICspInformation :

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Nome
• Tipo
• Válido
• Versão

O método adiciona os algoritmos disponíveis à coleção ICspAlgorithms retornada pela propriedade CspAlgorithms . Chame o método InitializeFromType para inicializar o objeto de um tipo de provedor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenroll.h
DLL	CertEnroll.dll

Confira também

ICspInformation