Compartilhar via


Função CryptFindLocalizedName (wincrypt.h)

A função CryptFindLocalizedName localiza o nome localizado para o nome especificado, como o nome de localização do repositório do sistema "Raiz". Essa função pode ser usada antes de exibir qualquer interface do usuário que inclua um nome que possa ter um formulário localizado.

Sintaxe

LPCWSTR CryptFindLocalizedName(
  [in] LPCWSTR pwszCryptName
);

Parâmetros

[in] pwszCryptName

Um ponteiro para um nome especificado. Uma tabela interna é pesquisada para comparar um nome localizado predefinido com o nome especificado. A pesquisa corresponde ao nome localizado usando uma comparação de cadeia de caracteres que não diferencia maiúsculas de minúsculas.

Nota Nomes localizados para os repositórios de sistema predefinidos ("Raiz", "Meu") e repositórios físicos predefinidos (". Padrão", ". LocalMachine") são pré-instalados como cadeias de caracteres de recurso no Crypt32.dll.
 

Valor retornado

Se o nome especificado for encontrado, um ponteiro para o nome localizado será retornado. O ponteiro retornado não deve ser liberado.

Se o nome especificado não for encontrado, NULL será retornado.

Comentários

CryptSetOIDFunctionValue pode ser chamado da seguinte maneira para registrar cadeias de caracteres localizadas adicionais.

dwEncodingType = CRYPT_LOCALIZED_NAME_ENCODING_TYPE

pszFuncName = CRYPT_OID_FIND_LOCALIZED_NAME_FUNC

pszOID = CRYPT_LOCALIZED_NAME_OID

pwszValueName = Nome a ser localizado, por exemplo, L"ApplicationStore"

dwValueType = REG_SZ

pbValueData = ponteiro para a cadeia de caracteres localizada Unicode

cbValueData = (wcslen(Cadeia de caracteres localizada Unicode) + 1) * sizeof(WCHAR)

CryptSetOIDFunctionValue pode ser chamado da seguinte maneira para cancelar o registro das cadeias de caracteres localizadas.

pbValueData = NULL

cbValueData = 0.

Os nomes registrados são pesquisados antes dos nomes pré-instalados.

CRYPT_LOCALIZED_NAME_ ENCODING_TYPE 0
CRYPT_LOCALIZED_NAME_ OID "LocalizedNames"
CRYPT_OID_FIND_LOCALIZED_ NAME_FUNC "CryptDLLFindLocalizedName"
 

Exemplos

Para obter um exemplo que usa essa função, consulte Exemplo de programa C: configurando e obtendo propriedades do repositório de certificados.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

CryptSetOIDFunctionValue

Funções Gerenciamento de Dados