영어로 읽기

다음을 통해 공유


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
ERROR_CAN_NOT_COMPLETE
라우팅 프로토콜을 초기화하지 못했습니다.
ERROR_INVALID_PARAMETER
GlobalInfo 매개 변수가 가리키는 매개 변수 중 하나가 잘못되었습니다.
 
 

요구 사항

요구 사항
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 routprot.h

추가 정보

GetEventMessage

라우팅 프로토콜 인터페이스 함수

라우팅 프로토콜 인터페이스 참조

SUPPORT_FUNCTIONS

StopProtocol