INetConnection::GetProperties 메서드(netcon.h)

[인터넷 연결 방화벽은 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 Windows 방화벽 API를 사용합니다.]

GetProperties 메서드는 이 네트워크 연결에 대한 속성을 포함하는 구조를 검색합니다.

구문

HRESULT GetProperties(
  [out] NETCON_PROPERTIES **ppProps
);

매개 변수

[out] ppProps

반환이 성공적일 때 이 네트워크 연결의 속성을 포함하는 NETCON_PROPERTIES 구조를 가리키는 포인터에 대한 포인터입니다.

반환 값

메서드가 성공하면 반환 값이 S_OK.

메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
E_ABORT	작업이 중단되었습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	매개 변수 중 하나가 잘못되었습니다.
E_NOINTERFACE	지정된 인터페이스는 지원되지 않습니다.
E_NOTIMPL	지정된 메서드가 구현되지 않았습니다.
E_OUTOFMEMORY	메서드가 필요한 메모리를 할당할 수 없습니다.
E_POINTER	매개 변수로 전달된 포인터가 잘못되었습니다.
E_UNEXPECTED	알 수 없는 이유로 메서드가 실패했습니다.

설명

호출 애플리케이션은 GetProperties에서 반환된 NETCON_PROPERTIES 구조체가 차지하는 메모리를 해제해야 합니다. NcFreeNetconProperties 함수를 호출하여 메모리를 해제합니다. 이 함수는 NetCon.h에서 정의되며 NetShell.dll 내보냅니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	netcon.h
DLL	Hnetcfg.dll