IDirectPlay8NATResolver::EnumDevices 메서드

네트워크 어드레스 변환 (NAT) 리절버를 시작 할 수 있는 이용 가능한 장치의 리스트를 열거한다.

구문

HRESULT EnumDevices(      

    DPN_SERVICE_PROVIDER_INFO *const pSPInfoBuffer,
    PDWORD const pdwBufferSize,
    PDWORD const pdwNumDevices,
    const DWORD dwFlags
);

파라미터

pSPInfoBuffer

[out] 서비스 프로바이더 정보를 보관 유지하는,DPN_SERVICE_PROVIDER_INFO 구조체의 배열의 포인터.

pdwBufferSize

[out] pSPInfoBuffer 버퍼의 사이즈가 저장 되는 DWORD 의 포인터.

pdwNumDevices

pSPInfoBuffer 에 돌려받는 DPN_SERVICE_PROVIDER_INFO 구조체의 수가 저장 되는 DWORD 의 포인터.

dwFlags

[in] 예약이 끝난 상태. NULL 로 설정하는 것.

반환값

성공했을 경우는 DPN_OK 를 돌려주어, 실패했을 경우는 다음의 몇개의 에러값을 돌려준다.

DPNERR_BUFFERTOOSMALL	지정된 버퍼가 너무 작아, 요구된 데이터를 저장 할 수 없다.
DPNERR_INVALIDFLAGS	이 메서드에 건네진 플래그는 무효이다.
DPNERR_INVALIDOBJECT	Microsoft® DirectPlay® 개체의 포인터는 무효이다.
DPNERR_INVALIDPARAM	메서드에 건네진 1 개 이상의 파라미터가 무효이다.
DPNERR_UNINITIALIZED	요구된 개체가 초기화되지 않다.

주의

pdwBufferSize 의 값에 의해, 버퍼가 너무 작아 장치의 리스트를 보관 유지할 수 없는 것이 나타나면 필요한 사이즈는 pdwBufferSize 에 들어가, DPNERR_BUFFERTOOSMALL 이 반환된다. 그 이외의 경우, 써넣어지는 사이즈는 pdwBufferSize 에 들어간다.