ldap_parse_result 함수(winldap.h)

아티클
08/27/2023

ldap_parse_result 함수는 서버의 응답을 구문 분석하고 적절한 필드를 반환합니다.

구문

WINLDAPAPI ULONG LDAPAPI ldap_parse_result(
  [in]            LDAP          *Connection,
  [in]            LDAPMessage   *ResultMessage,
  [out, optional] ULONG         *ReturnCode,
  [out, optional] PSTR          *MatchedDNs,
  [out, optional] PSTR          *ErrorMessage,
  [out, optional] PSTR          **Referrals,
  [out, optional] PLDAPControlA **ServerControls,
  [in]            BOOLEAN       Freeit
);

매개 변수

[in] Connection

세션 핸들입니다.

[in] ResultMessage

동기 작업 호출 중 하나 또는 비동기 작업에 대한 ldap_result 반환된 LDAP 작업의 결과입니다.

[out, optional] ReturnCode

원래 결과 메시지를 생성한 서버 작업의 결과를 나타냅니다. 이 필드를 무시하려면 NULL 을 전달합니다.

[out, optional] MatchedDNs

null로 끝나는 넓은 문자열에 대한 포인터입니다. LDAP_NO_SUCH_OBJECT 반환하는 경우 이 결과 매개 변수는 요청에서 인식된 이름의 양을 나타내는 고유 이름으로 채워집니다. 이 필드를 무시하려면 NULL 을 전달합니다.

[out, optional] ErrorMessage

ResultMessage 매개 변수의 오류 메시지 필드 내용이 포함된 null로 끝나는 넓은 문자열에 대한 포인터입니다. 이 필드를 무시하려면 NULL 을 전달합니다.

[out, optional] Referrals

요청을 다시 시도해야 하는 0개 이상의 대체 LDAP 서버를 나타내는 ResultMessage 매개 변수의 조회 필드 내용이 포함된 null로 끝나는 넓은 문자열에 대한 포인터입니다. 이 필드를 무시하려면 NULL 을 전달합니다.

[out, optional] ServerControls

이 결과 매개 변수는 ResultMessage 매개 변수에서 복사된 할당된 컨트롤 배열로 채워집니다.

[in] Freeit

ResultMessage 매개 변수가 해제되었는지 여부를 결정합니다. 0이 아닌 값을 Freeit 매개 변수에 전달하여 ResultMessage 포인터가 더 이상 필요하지 않은 경우 해제하거나 ldap_msgfree 호출하여 나중에 결과를 해제할 수 있습니다.

반환 값

함수가 성공하면 반환 값이 LDAP_SUCCESS.

함수가 실패하면 오류 코드를 반환합니다. 자세한 내용은 반환 값을 참조하세요.

설명

ldap_parse_result 함수는 구문 분석할 결과 메시지를 찾는 서버 응답 체인을 트래버스합니다. 조회, 일치하는 고유 이름 또는 반환된 서버 컨트롤에 액세스하려면 이 함수를 사용합니다. 함수는 LDAP_RES_SEARCH_ENTRY 및LDAP_RES_SEARCH_REFERENCE 형식의 메시지를 건너뜁니다.

더 이상 필요하지 않은 경우 ldap_memfree 호출하여 ErrorMessage 및 MatchedDNs 문자열을 해제합니다. ldap_value_free 호출하여 조회 배열을해제합니다. ldap_controls_free 호출하여 ServerControls를 해제합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	winldap.h
라이브러리	Wldap32.lib
DLL	Wldap32.dll