DsCrackSpnA 함수(dsparse.h)
DsCrackSpn 함수는 SPN(서비스 사용자 이름)을 구성 요소 문자열로 구문 분석합니다.
통사론
DSPARSE DWORD DsCrackSpnA(
[in] LPCSTR pszSpn,
[in, out, optional] LPDWORD pcServiceClass,
[out, optional] LPSTR ServiceClass,
[in, out, optional] LPDWORD pcServiceName,
[out, optional] LPSTR ServiceName,
[in, out, optional] LPDWORD pcInstanceName,
[out, optional] LPSTR InstanceName,
[out, optional] USHORT *pInstancePort
);
매개 변수
[in] pszSpn
구문 분석할 SPN을 포함하는 null로 끝나는 상수 문자열에 대한 포인터입니다. SPN에는 <서비스 클래스> 및 <인스턴스 이름> 구성 요소가 있어야 하고 <포트 번호> 및 <서비스 이름> 구성 요소가 선택 사항인 형식이 있습니다. <포트 번호> 구성 요소는 숫자 문자열 값이어야 합니다.
<service class>/<instance name>:<port number>/<service name>
[in, out, optional] pcServiceClass
항목에서 종료 null 문자를 포함하여 ServiceClass 버퍼의 크기(TCHAR)를 포함하는 DWORD 값에 대한 포인터입니다. 종료할 때 이 매개 변수에는 종료 null 문자를 포함하여 ServiceClass 문자열의 TCHAR 수가 포함됩니다.
이 매개 변수가 NULL
null 종결자를 포함하여 ServiceClass 문자열에 필요한 문자 수를 가져오려면 유효한 SPN,NULLServiceClass 및 이 매개 변수를 1로 설정하여 이 함수를 호출합니다.
[out, optional] ServiceClass
SPN의 <서비스 클래스> 구성 요소가 포함된 null로 끝나는 문자열을 수신하는 TCHAR 버퍼에 대한 포인터입니다. 이 버퍼의 크기는 *pcServiceClass
[in, out, optional] pcServiceName
항목에서 종료 null 문자를 포함하여 ServiceName 버퍼의 크기(TCHAR)를 포함하는 DWORD 값에 대한 포인터입니다. 종료할 때 이 매개 변수에는 종료 null 문자를 포함하여 ServiceName 문자열의 TCHAR 수가 포함됩니다.
이 매개 변수가 NULL
null 종결자를 포함하여 ServiceName 문자열에 필요한 문자 수를 가져오려면 유효한 SPN,NULLServiceName 이 매개 변수를 1로 설정하여 이 함수를 호출합니다.
[out, optional] ServiceName
SPN의 <서비스 이름> 구성 요소가 포함된 null로 끝나는 문자열을 수신하는 TCHAR 버퍼에 대한 포인터입니다. 이 버퍼는 최소 *pcServiceName TCHAR 크기여야 합니다. spN에 <서비스 이름> 구성 요소가 없는 경우 이 버퍼는 <인스턴스 이름> 구성 요소를 받습니다. 서비스 이름이 필요하지 않은 경우 이 매개 변수는 NULL
[in, out, optional] pcInstanceName
항목에서 종료 null 문자를 포함하여 InstanceName 버퍼의 크기(TCHAR)를 포함하는 DWORD 값에 대한 포인터입니다. 종료할 때 이 매개 변수는 종료 null 문자를 포함하여
이 매개 변수가 NULL
null 종결자를 포함하여 InstanceName 문자열에 필요한 문자 수를 가져오려면 유효한 SPN,NULLInstanceName 및 이 매개 변수를 1로 설정하여 이 함수를 호출합니다.
[out, optional] InstanceName
SPN의 <인스턴스 이름> 구성 요소가 포함된 null로 끝나는 문자열을 수신하는 TCHAR 버퍼에 대한 포인터입니다. 이 버퍼는 최소 *pcInstanceName TCHAR 크기여야 합니다. 인스턴스 이름이 필요하지 않은 경우 이 매개 변수는 NULL
[out, optional] pInstancePort
SPN의 <포트 번호> 구성 요소의 정수 값을 받는 DWORD 값에 대한 포인터입니다. SPN에 <포트 번호> 구성 요소가 없는 경우 이 매개 변수는 0을 받습니다. 포트 번호가 필요하지 않은 경우 이 매개 변수는 NULL
반환 값
다음을 포함하여 Win32 오류 코드를 반환합니다.
발언
메모
dsparse.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsCrackSpn을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsparse.h(Ntdsapi.h 포함) |
| 라이브러리 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |