Método ICertEncodeStringArray::Reset (certenc.h)

Artigo
02/26/2024

O método Reset especifica o tamanho da matriz de cadeia de caracteres e o tipo de cadeias de caracteres que a matriz conterá. Os valores de todos os elementos na matriz de cadeia de caracteres são definidos como zero.

Você deve chamar esse método antes de chamar o método ICertEncodeStringArray::SetValue pela primeira vez.

Sintaxe

HRESULT Reset(
  [in] LONG Count,
  [in] LONG StringType
);

Parâmetros

[in] Count

Especifica o número de elementos na matriz de cadeia de caracteres.

[in] StringType

Especifica o tipo de cadeias de caracteres que a matriz de cadeia de caracteres contém. O tipo deve ser um dos valores a seguir. Para obter mais informações sobre tipos RDN, consulte os documentos do CryptoAPI 2.0.

Valor	Significado
CERT_RDN_ANY_TYPE	Para codificar um nome X509_UNICODE_NAME.
CERT_RDN_NUMERIC_STRING	Os caracteres de 0 a 9 e o caractere de espaço (8 bits).
CERT_RDN_PRINTABLE_STRING	Caracteres imprimíveis (8 bits).
CERT_RDN_T61_STRING	Caracteres codificados em T.61 (8 bits).
CERT_RDN_VIDEOTEX_STRING	Caracteres VIDEOTEX.
CERT_RDN_IA5_STRING	Caracteres IA5 (ASCII).
CERT_RDN_GRAPHIC_STRING	Uma cadeia de caracteres GRÁFICOs definidos por ISO.
CERT_RDN_ISO646_STRING	Conjunto de 128 caracteres (8 bits).
CERT_RDN_GENERAL_STRING	Uma cadeia de caracteres GERAL definida por ISO.
CERT_RDN_INT4_STRING	Uma matriz de valores INT4 (32 bits).
CERT_RDN_UNICODE_STRING	Caracteres Unicode (16 bits).

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certenc.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certenc.dll

Confira também

ICertEncodeStringArray

Compartilhar via