SERVICE_INFOA 구조체(nspapi.h)
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
네트워크 검색 사용자 인터페이스에서 네트워크 서비스를 표시하는 방법에 대한 힌트입니다. 다음 값 중 하나일 수 있습니다.
dwVersion
형식:DWORD
네트워크 서비스의 버전입니다. 이 값의 상위 단어는 주 버전 번호를 지정합니다. 이 값의 하위 단어는 부 버전 번호를 지정합니다.
dwTime
형식:DWORD
다음에 사용하도록 예약됩니다. 0이어야 합니다.
lpMachineName
형식: LPTSTR
네트워크 서비스가 실행 중인 컴퓨터의 이름인 NULL로 끝나는 문자열에 대한 포인터입니다.
lpServiceAddress
형식: LPSERVICE_ADDRESSES
SERVICE_ADDRESS 구조체의 배열을 포함하는 SERVICE_ADDRESSES 구조체에 대한 포인터입니다. 각 SERVICE_ADDRESS 구조에는 네트워크 서비스 주소에 대한 정보가 포함됩니다.
네트워크 서비스는 getsockname 함수를 호출하여 시스템의 로컬 주소를 확인할 수 있습니다.
ServiceSpecificInfo
형식: BLOB
서비스 정의 정보를 지정하는 BLOB 구조체입니다.
설명
참고
nspapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SERVICE_INFO 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | nspapi.h |