PSTART_PROTOCOL 콜백 함수(routprot.h)
StartProtocol 함수는 라우팅 프로토콜의 기능을 초기화합니다. 라우터 관리자는 이 함수를 사용하여 라우팅 프로토콜 전역 구성 매개 변수 및 API 진입점 집합을 전달합니다. 프로토콜은 이러한 진입점을 사용하여 라우터 관리자를 호출합니다.
PSTART_PROTOCOL PstartProtocol;
DWORD PstartProtocol(
[in] HANDLE NotificationEvent,
[in] PSUPPORT_FUNCTIONS SupportFunctions,
[in] LPVOID GlobalInfo,
[in] ULONG StructureVersion,
[in] ULONG StructureSize,
[in] ULONG StructureCount
)
{...}
[in] NotificationEvent
이벤트 개체에 대한 핸들입니다. 라우팅 프로토콜은 라우터 관리자가 프로토콜에서 유지 관리하는 큐에서 비동기 메시지를 검색하려고 할 때 이 이벤트를 신호로 보냅니다.
[in] SupportFunctions
SUPPORT_FUNCTIONS 구조체에 대한 포인터입니다. 이 구조체의 필드는 라우터 관리자의 함수에 대한 포인터입니다. 이러한 함수를 사용하면 프로토콜이 라우팅 프로토콜에 걸쳐 있는 정보에 액세스할 수 있습니다.
[in] GlobalInfo
인터페이스별 구성 정보가 아닌 프로토콜 정의 전역을 가리키는 포인터입니다. 이 정보는 라우팅 프로토콜에 비공개입니다.
[in] StructureVersion
GlobalInfo 매개 변수가 가리키는 정보 구조의 버전을 지정합니다. 경우에 따라 라우팅 프로토콜의 버전과 같습니다.
[in] StructureSize
GlobalInfo 매개 변수가 가리키는 각 정보 구조의 크기를 지정합니다. 일부 정보 구조에는 가변 길이 멤버가 포함되어 있으므로 라우팅 프로토콜이 반드시 버전에서 정보의 크기를 확인할 수 있는 것은 아닙니다.
[in] StructureCount
GlobalInfo 매개 변수가 가리키는 정보 구조의 개수를 지정합니다. 이 매개 변수는 항상 하나입니다.
함수가 성공하고 프로토콜이 인터페이스 정보를 받을 준비가 되면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
값 | Description |
---|---|
|
라우팅 프로토콜을 초기화하지 못했습니다. |
|
GlobalInfo 매개 변수가 가리키는 매개 변수 중 하나가 잘못되었습니다. |
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | routprot.h |