SERVICE_INFOA 구조체(nspapi.h)

아티클
03/15/2023

SERVICE_INFO 구조에는 네트워크 서비스 또는 네트워크 서비스 유형에 대한 정보가 포함됩니다.

구문

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

멤버

lpServiceType

형식: LPGUID

네트워크 서비스의 형식인 GUID에 대한 포인터입니다.

lpServiceName

형식: LPTSTR

네트워크 서비스의 이름인 NULL로 끝나는 문자열에 대한 포인터입니다.

dwNameSpace 매개 변수가 NS_DEFAULT 설정된 SetService 함수를 호출하는 경우 네트워크 서비스 이름은 일반 이름이어야 합니다. 일반적인 이름은 네트워크 서비스가 일반적으로 알려진 이름입니다. 네트워크 서비스의 일반적인 이름 예는 "My SQL Server"입니다.

dwNameSpace 매개 변수가 특정 서비스 이름으로 설정된 SetService 함수를 호출하는 경우 네트워크 서비스 이름은 일반 이름 또는 고유 이름일 수 있습니다. 고유 이름은 디렉터리 서비스를 사용하여 서비스를 고유한 위치로 구분합니다. 네트워크 서비스에 대한 고유 이름의 예는 "MS\SYS\NT\DEV\My SQL Server"입니다.

lpComment

형식: LPTSTR

네트워크 서비스에 대한 주석 또는 설명인 NULL로 끝나는 문자열에 대한 포인터입니다. 예를 들어 "개발 업그레이드에 사용됨"이 있습니다.

lpLocale

형식: LPTSTR

로캘 정보를 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다.

dwDisplayHint

형식:DWORD

네트워크 검색 사용자 인터페이스에서 네트워크 서비스를 표시하는 방법에 대한 힌트입니다. 다음 값 중 하나일 수 있습니다.

값	의미
RESOURCEDISPLAYTYPE_DOMAIN	네트워크 서비스를 도메인으로 표시합니다.
RESOURCEDISPLAYTYPE_FILE	네트워크 서비스를 파일로 표시합니다.
RESOURCEDISPLAYTYPE_GENERIC	개체를 표시하는 데 사용되는 메서드는 중요하지 않습니다.
RESOURCEDISPLAYTYPE_GROUP	네트워크 서비스를 그룹으로 표시합니다.
RESOURCEDISPLAYTYPE_SERVER	네트워크 서비스를 서버로 표시합니다.
RESOURCEDISPLAYTYPE_SHARE	네트워크 서비스를 SharePoint로 표시합니다.
RESOURCEDISPLAYTYPE_TREE	네트워크 서비스를 트리로 표시합니다.

dwVersion

형식:DWORD

네트워크 서비스의 버전입니다. 이 값의 상위 단어는 주 버전 번호를 지정합니다. 이 값의 하위 단어는 부 버전 번호를 지정합니다.

dwTime

형식:DWORD

다음에 사용하도록 예약됩니다. 0이어야 합니다.

lpMachineName

형식: LPTSTR

네트워크 서비스가 실행 중인 컴퓨터의 이름인 NULL로 끝나는 문자열에 대한 포인터입니다.

lpServiceAddress

형식: LPSERVICE_ADDRESSES

SERVICE_ADDRESS 구조체의 배열을 포함하는 SERVICE_ADDRESSES 구조체에 대한 포인터입니다. 각 SERVICE_ADDRESS 구조에는 네트워크 서비스 주소에 대한 정보가 포함됩니다.

네트워크 서비스는 getsockname 함수를 호출하여 시스템의 로컬 주소를 확인할 수 있습니다.

ServiceSpecificInfo

형식: BLOB

서비스 정의 정보를 지정하는 BLOB 구조체입니다.

참고 일반적으로 BLOB 구조체의 pBlobData 멤버가 가리키는 데이터에는 포인터가 없어야 합니다. 네트워크 서비스만 데이터 형식을 알고 있기 때문입니다. 이러한 지식 없이 데이터를 복사하면 포인터 무효화가 발생할 수 있습니다. pBlobData가 가리키는 데이터에 가변 크기 요소가 포함된 경우 pBlobData의 오프셋을 사용하여 해당 요소의 위치를 나타낼 수 있습니다. 이 일반 규칙에는 pBlobData 가 SERVICE_TYPE_INFO_ABS 구조를 가리키는 경우 한 가지 예외가 있습니다. 이는 SERVICE_TYPE_INFO_ABS 구조체와 구조체에 포함된 모든 SERVICE_TYPE_VALUE_ABS 구조체가 미리 정의되어 있으므로 해당 형식이 운영 체제에 알려지므로 가능합니다.

설명

참고

nspapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SERVICE_INFO 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	nspapi.h