Função DsQuoteRdnValueA (dsparse.h)
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 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 sem aspas.
[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 a psQuotedRdnValue.
[out] psQuotedRdnValue
A cadeia de caracteres que recebe o valor rdn convertido e, talvez, entre aspas.
Valor retornado
A lista a seguir contém os valores possíveis retornados para a função DsQuoteRdnValue .
Comentários
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 em NULL.
Para reverter alterações feitas por essa chamada, chame a função DsUnquoteRdnValue.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | dsparse.h (inclua Ntdsapi.h) |
| Biblioteca | Ntdsapi.lib |
| DLL | Ntdsapi.dll |
Confira também
Funções de gerenciamento de replicação e controlador de domínio