Função DsUnquoteRdnValueA (dsparse.h)

Artigo
11/20/2024

A função DsUnquoteRdnValue é uma chamada de cliente que converte um valor RDN entre aspas em um valor RDN não cotado. Como o RDN foi originalmente colocado entre aspas porque continha caracteres que poderiam ser mal interpretados quando ele foi inserido em um DN (nome diferenciado), o valor RDN não cotado não deve ser enviado como parte de um DN para o serviço de diretório usando várias APIs, como LDAP.

Sintaxe

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

Parâmetros

[in] cQuotedRdnValueLength

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

[in] psQuotedRdnValue

O valor RDN que pode ser citado e escapado.

[in, out] pcUnquotedRdnValueLength

O valor de entrada para esse argumento é o comprimento máximo, em caracteres, de psQuotedRdnValue.

O valor de saída desse argumento inclui os sinalizadores a seguir.

ERROR_SUCCESS

Isso será retornado se o número de caracteres corresponder à cadeia de caracteres usada em psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Isso será retornado se o número de caracteres não corresponder à cadeia de caracteres usada em psQuotedRdnValue.

[out] psUnquotedRdnValue

O valor rdn convertido e não coqueado.

Valor de retorno

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

Observações

Quando psQuotedRdnValue é citado:

As aspas à esquerda e à direita são removidas.
Espaço em branco antes da primeira aspa ser descartada.
O espaço em branco à direita da última aspa é descartado.
Escapes são removidos e o caractere após a fuga é mantido.

As seguintes ações são executadas quando psQuotedRdnValue não é citado:

O espaço em branco à esquerda é descartado.
O espaço em branco à direita é mantido.
Caracteres não especiais com escape retornam um erro.
Caracteres especiais sem escape retornam um erro.
Os valores RDN que começam com # (ignorando o espaço em branco à esquerda) são tratados como um valor BER que foi convertido anteriormente em uma cadeia de caracteres e convertidos adequadamente.
Os dígitos hexadecimais com escape (\89) são convertidos em um byte binário (0x89).
Escapes são removidos de caracteres especiais com escape.

As seguintes ações são sempre executadas:

Os caracteres especiais com escape não são escapados.
Os valores RDN de entrada e saída não são valores encerrados em nulo.

Nota

O cabeçalho dsparse.h define DsUnquoteRdnValue 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

DsQuoteRdnValue

Compartilhar via