ADsEncodeBinaryData-Funktion (adshlp.h)

Die Funktion ADsEncodeBinaryData konvertiert ein binäres großes Objekt (Blob) in das Unicode-Format, das zum Eingebettet in einen Suchfilter geeignet ist.

Syntax

HRESULT ADsEncodeBinaryData(
  [in]  PBYTE  pbSrcData,
  [in]  DWORD  dwSrcLen,
  [out] LPWSTR *ppszDestData
);

Parameter

[in] pbSrcData

Typ: PBYTE

Zu konvertierende BLOBs.

[in] dwSrcLen

Art: DWORD

Größe des BLOB in Byte.

[out] ppszDestData

Typ: LPWSTR*

Zeiger auf eine unicode-Zeichenfolge, die null endet und die konvertierten Daten empfängt.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt die standardmäßigen Rückgabewerte sowie folgendes.

Hinweise

In ADSI müssen Suchfilter Unicode-Zeichenfolgen sein. Manchmal enthält ein Filter Daten, die normalerweise durch ein undurchsichtiges BLOB mit Daten dargestellt werden. Sie können z. B. eine Objektsicherheits-ID in einen Suchfilter einschließen, bei dem es sich um Binärdaten handelt. In diesem Fall müssen Sie zuerst die Funktion ADsEncodeBinaryData aufrufen, um die Binärdaten in das Unicode-Zeichenfolgenformat zu konvertieren. Wenn die Daten nicht mehr benötigt werden, rufen Sie die FreeADsMem-Funktion auf, um die konvertierte Unicode-Zeichenfolge frei zu geben. d. h. ppszDestData.

Die ADsEncodeBinaryData-Funktion codiert keine Bytewerte, die alphanumerische Zeichen darstellen. Stattdessen wird das Zeichen ohne Codierung in die Zeichenfolge eingefügt. Dies führt dazu, dass die Zeichenfolge eine Mischung aus codierten und nicht codierten Zeichen enthält. Wenn die Binärdaten beispielsweise 0x05|0x1A|0x1B|0x43|0x32 sind, enthält die codierte Zeichenfolge "\05\1A\1BC2". Dies hat keine Auswirkungen auf den Filter, und die Suchfilter funktionieren mit diesen Zeichenfolgentypen ordnungsgemäß.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Funktion veranschaulicht.

// Test binary values in filters and use
// a binary filter instead of a string filter in ExecuteSearch.

LPWSTR pszPrefix = L"objectSid=%s";
LPWSTR pszBinaryFilter = NULL;
LPWSTR pszDest = NULL;
HRESULT hr = S_OK;
 
BYTE column[] = {
  0x01, 0x05, 0x00, 0x00, 0x00, 0x00, 0x00, 0x05, 0x15, 0x00,
  0x00, 0x00, 0x59, 0x51, 0xb8, 0x17, 0x66, 0x72, 0x5d, 0x25,
  0x64, 0x63, 0x3b, 0x0b, 0x29, 0x99, 0x21, 0x00 };

DWORD dwSize = sizeof(column)/sizeof(BYTE);
 
hr = ADsEncodeBinaryData (
    column,
    dwSize,
    &pszDest
    );

if(hr==S_OK)
{
    dwSize = wcslen(pszPrefix) + wcslen(pszDest) + 1;
    pszBinaryFilter = new WCHAR[dwSize];
    sprintf_s(pszBinaryFilter,pszPrefix,pszDest);
}
else
{
    return hr;
}


 
// Perform the search with the pszDest as the filter string. Code omitted.
. . . 
// Done with the search and free the converted string.
FreeADsMem( pszDest );

Anforderungen

Weitere Informationen

ADSI-Fehlercodes

ADSI-Funktionen

FreeADsMem