Compartilhar via


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

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