NetMessageNameEnum 함수(lmmsg.h)

아티클
08/24/2023

[이 함수는 메신저 서비스가 지원되지 않으므로 Windows Vista에서 지원되지 않습니다.]

NetMessageNameEnum 함수는 지정된 컴퓨터에서 메시지를 받는 메시지 별칭을 나열합니다. 함수를 사용하려면 메신저 서비스를 시작해야 합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetMessageNameEnum(
  [in]      LPCWSTR servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

매개 변수

[in] servername

함수를 실행할 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[in] level

데이터의 정보 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
0	메시지 별칭을 반환합니다. bufptr 매개 변수는 MSG_INFO_0 구조체의 배열을 가리킵니다.
1	메시지 별칭을 반환합니다. bufptr 매개 변수는 MSG_INFO_1 구조체의 배열을 가리킵니다. 이 수준은 호환성을 위해서만 존재합니다. 메시지 전달은 지원되지 않습니다.

[out] bufptr

데이터를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 수준 매개 변수의 값에 따라 달라집니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 함수가 ERROR_MORE_DATA 실패하더라도 버퍼를 해제해야 합니다.

[in] prefmaxlen

반환된 데이터의 기본 설정 최대 길이(바이트)를 지정합니다. MAX_PREFERRED_LENGTH 지정하는 경우 함수는 데이터에 필요한 메모리 양을 할당합니다. 이 매개 변수에 다른 값을 지정하면 함수가 반환하는 바이트 수를 제한할 수 있습니다. 버퍼 크기가 모든 항목을 보유하기에 충분하지 않으면 함수는 ERROR_MORE_DATA 반환합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크 관리 함수 버퍼 길이를 참조하세요.

[out] entriesread

실제로 열거된 요소 수를 받는 값에 대한 포인터입니다.

[out] totalentries

현재 다시 시작 위치에서 열거할 수 있는 총 항목 수를 수신하는 값에 대한 포인터입니다. 애플리케이션은 이 값을 힌트로만 고려해야 합니다.

[in, out] resume_handle

기존 메시지 별칭 검색을 계속하는 데 사용되는 다시 시작 핸들이 포함된 값에 대한 포인터입니다. 핸들은 첫 번째 호출에서 0이어야 하며 후속 호출의 경우 변경되지 않은 상태로 유지되어야 합니다. resume_handleNULL이면 다시 시작 핸들이 저장되지 않습니다.

반환 값

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_ACCESS_DENIED	호출자에게 작업을 완료할 수 있는 적절한 액세스 권한이 없습니다.
ERROR_INVALID_LEVEL	level 매개 변수에 지정된 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다.
ERROR_MORE_DATA	더 많은 항목을 사용할 수 있습니다. 모든 항목을 수신할 수 있을 만큼 큰 버퍼를 지정합니다.
ERROR_NOT_ENOUGH_MEMORY	사용 가능한 메모리가 부족합니다.
ERROR_NOT_SUPPORTED	이 요청은 지원되지 않습니다. 이 오류는 Windows Vista 이상에서 반환됩니다.
NERR_BufTooSmall	제공된 버퍼가 너무 작습니다.

설명

관리자 로컬 그룹의 멤버만 원격 서버에서 NetMessageNameEnum 함수를 성공적으로 실행할 수 있습니다.

메시지 이름 테이블에서 특정 메시지 별칭에 대한 정보를 검색하려면 NetMessageNameGetInfo 함수를 호출하면 됩니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	lmmsg.h(Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll