Função DsQuoteRdnValueA (dsparse.h)

Artigo
11/20/2024

A função DsQuoteRdnValue converterá um RDN em um valor RDN entre aspas, se o valor RDN contiver caracteres que exigem aspas. O RDN entre aspas pode ser enviado como parte de um DN (nome diferenciado) para o serviço de diretório usando várias APIs, como LDAP. Um exemplo de UM RDN que exigiria aspas seria aquele que tem um valor separado por vírgulas, como um RDN para um nome que usa o formato "last,first".

Sintaxe

DSPARSE DWORD DsQuoteRdnValueA(
  [in]      DWORD cUnquotedRdnValueLength,
  [in]      LPCCH psUnquotedRdnValue,
  [in, out] DWORD *pcQuotedRdnValueLength,
  [out]     LPCH  psQuotedRdnValue
);

Parâmetros

[in] cUnquotedRdnValueLength

O número de caracteres na cadeia de caracteres psUnquotedRdnValue.

[in] psUnquotedRdnValue

A cadeia de caracteres que especifica o valor RDN não definido.

[in, out] pcQuotedRdnValueLength

O número máximo de caracteres na cadeia de caracteres psQuotedRdnValue .

Os sinalizadores a seguir são a saída para esse parâmetro.

ERROR_SUCCESS

Indica que o número correto de caracteres foi encontrado em psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Indica que o número de caracteres na cadeia de caracteres não corresponde psQuotedRdnValue.

[out] psQuotedRdnValue

A cadeia de caracteres que recebe o valor RDN convertido e, talvez, entre aspas.

Valor de retorno

A lista a seguir contém os valores possíveis retornados para a função DsQuoteRdnValue.

Observações

As aspas não serão adicionadas ao RDN se nenhuma for necessária. Nesse caso, o valor rdn de saída é o mesmo que o valor RDN de entrada.

Quando aspas são necessárias, o RDN é citado de acordo com a especificação "Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names", RFC 2253.

Os valores RDN de entrada e saída não são cadeias de caracteres terminadas porNULL.

Para reverter as alterações feitas por essa chamada, chame a função DsUnquoteRdnValue.

Nota

O cabeçalho dsparse.h define DsQuoteRdnValue como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	dsparse.h (inclua Ntdsapi.h)
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

Funções de gerenciamento de replicação e controlador de domínio

DsUnquoteRdnValue

Compartilhar via