LPM_GetRsvpObjects 함수(lpmapi.h)

LPM_GetRsvpObjects 함수를 사용하면 PCM에서 정책 데이터에 대한 LPM을 쿼리할 수 있습니다. 데이터는 정책 데이터가 필요한 RSVP 새로 고침 메시지에 포함하기 위해 PCM에서 SBM으로 전달됩니다. LPM_GetRsvpObjects 함수의 결과를 동기적으로 또는 비동기적으로 반환할 수 있습니다. 비동기 결과는 cbGetRsvpObjects 콜백 함수를 호출하여 반환됩니다.

구문

ULONG LPM_GetRsvpObjects(
  [in]  RHANDLE       PcmReqHandle,
  [in]  ULONG         MaxPdSize,
  [in]  RSVP_HOP      *SendingIntfAddr,
  [in]  RSVP_MSG_OBJS *pRsvpMsgObjs,
  [out] int           *pRsvpObjectsCount,
  [out] RsvpObjHdr    ***pppRsvpObjects,
  [out] void          *Reserved
);

매개 변수

[in] PcmReqHandle

이 요청을 다른 모든 요청과 구분하는 고유 핸들입니다. lPM은 cbGetRsvpObjects 콜백 함수를 사용하여 결과를 비동기적으로 반환할 때 이 PcmReqHandle을 사용해야 합니다.

[in] MaxPdSize

반환된 정책 데이터의 최대 허용 크기입니다.

[in] SendingIntfAddr

RSVP 메시지를 보낼 인터페이스에 대한 포인터입니다. 송신 인터페이스 IP 주소는 RSVP HOP 개체로 제공됩니다. 이 개체는 PATH 메시지의 경우 PHOP 및 RESV 메시지의 경우 NHOP와 동일합니다. 논리 인터페이스 핸들은 SNMP 인덱스로 설정됩니다. 인터페이스 인덱스 번호는 Windows 2000의 플러그 앤 플레이 기능으로 인해 인터페이스의 추가 및 삭제와 함께 변경 될 수 있습니다.

[in] pRsvpMsgObjs

SBM에서 생성된 RSVP 개체입니다. 모든 RSVP 개체는 호스트 순서입니다. 다음 표의 개체가 제공됩니다.

값	의미
RsvpMsgType	RSVP 프로토콜에 정의된 RSVP 메시지 유형입니다. LPM에서 정책 데이터 개체를 생성할 수 있는 상태를 찾는 데 사용할 수 있습니다.
RsvpSession	SBM에 정책 정보가 필요한 RSVP 세션입니다. LPM에서 정책 데이터 개체를 생성할 수 있는 상태를 찾는 데 사용할 수 있습니다.
RsvpHop	RSVP 메시지를 전달할 HOP입니다. PATH 메시지는 세션 주소로 직접 전송되므로 이 HOP 포인터는 PATH 메시지에 대한 NULL 입니다. 다른 모든 메시지의 경우 HOP 개체의 주소는 노드 주소이고 LIH는 사용되지 않습니다.
RsvpStyle	RSVP 프로토콜에 정의된 RSVP 예약 스타일입니다. SBM에서 RESV 메시지를 보내는 경우 RsvpStyle은 예약 스타일을 지정합니다. PATH 메시지를 보내는 경우 RsvpStyle은 NULL입니다.
RsvpScope	RSVP는 SCOPE 개체가 NULL이 아닌 한 나가는 RESV 메시지의 scope. WF 스타일 예약에만 사용됩니다. 다른 모든 RSVP 예약 스타일의 경우 RsvpScope는 NULL입니다.
FlowDescCount	흐름 설명자 수입니다.
FlowDescList	나가는 RSVP 메시지의 흐름 설명자 포인터 배열입니다. PATH 메시지의 경우 보낸 사람 템플릿 및 보낸 사람 Tspec을 포함하는 FlowDescriptor가 하나만 있습니다.

[out] pRsvpObjectsCount

반환되는 정책 개체 수에 대한 포인터입니다. LPM이 결과를 즉시 반환하는 경우 pRsvpObjectsCount 및 pppRsvpObjects 매개 변수를 사용하여 정책 데이터 개체를 반환해야 합니다. 정책 데이터 개체를 포함하는 버퍼는 LPM_Initialize 함수 내에서 제공되는 메모리 할당 함수 PALLOCMEM을 사용하여 할당해야 합니다.

[out] pppRsvpObjects

요청에 대한 응답으로 반환된 정책 데이터 개체 포인터 배열에 대한 포인터입니다. 정책 데이터 개체를 포함하는 버퍼와 이 정책 데이터 개체 포인터 배열은 LPM_Initialize 함수 내에서 제공되는 메모리 할당 함수 PALLOCMEM을 사용하여 할당되어야 합니다.

[out] Reserved

다음에 사용하도록 예약됩니다.

반환 값

이 함수는 ULONG을 반환합니다.

설명

LPM에 LPM_GetRsvpObjects 함수 호출에서 반환할 정책 데이터가 없는 경우 LPM_RESULT_READY 동기적으로 반환하고, pppRsvpObjects를 NULL로 설정하고, pRsvpObjectsCount를 0으로 설정해야 합니다. 동기 반환이 불가능한 경우 LPM은 LPM_RESULT_DEFER 반환하고 cbGetRsvpObjects 콜백 함수를 호출하여 결과를 반환해야 합니다. LPM에 반환할 정책 데이터 개체가 없는 경우 pppRsvpObjects 를 NULL 로 설정하고 pRsvpObjectsCount 를 0으로 설정할 수 있습니다.

LPM이 LPV_DROP_MSG 반환하는 경우 SBM은 RSVP 새로 고침 메시지를 보내지 않으며 다른 LPM에서 반환된 정책 데이터 개체(LPM_DROP_MSG 반환하지 않은 개체(있는 경우)를 해제합니다. RSVP 새로 고침 메시지를 보내지 않으면 흐름의 RSVP 상태가 업스트림 다운스트림 모두 사용이 시작되고 결국 삭제됩니다.

참고 SBM은 일부 또는 모든 LPM이 정책 데이터 개체를 적시에 반환하지 못하는 경우에도 RSVP 새로 고침 메시지를 보냅니다. 이러한 나가는 RSVP 메시지에 필요한 모든 정책 데이터 개체가 포함되지 않을 수 있습니다.

요구 사항

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