Compartilhar via

Função DsUnquoteRdnValueA (dsparse.h)

  • Artigo

A função DsUnquoteRdnValue é uma chamada de cliente que converte um valor RDN entre aspas de volta 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 citado 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 citado.

Valor retornado

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

Comentários

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.
  • Os 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 de escape retornam um erro.
  • Caracteres especiais sem escape retornam um erro.
  • Os valores de 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 convertido de acordo.
  • Os dígitos hexadecimais de escape (\89) são convertidos em um byte binário (0x89).
  • Os escapes são removidos de caracteres especiais com escape.
As seguintes ações são sempre executadas:
  • Os caracteres especiais escapados não são escapados.
  • Os valores RDN de entrada e saída não são valores encerrados em nulo.

Observação

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 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

DsQuoteRdnValue