SERVICE_DESCRIPTIONA struttura (winsvc.h)
Contiene una descrizione del servizio.
Sintassi
typedef struct _SERVICE_DESCRIPTIONA {
LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;
Members
lpDescription
Descrizione del servizio. Se questo membro è NULL, la descrizione rimane invariata. Se questo valore è una stringa vuota (""), la descrizione corrente viene eliminata.
La descrizione del servizio non deve superare le dimensioni di un valore del Registro di sistema di tipo REG_SZ.
Questo membro può specificare una stringa localizzata usando il formato seguente:
@[path]dllname,-strID
La stringa con identificatore strID viene caricata da dllname; il percorso è facoltativo. Per altre informazioni, vedere RegLoadMUIString.
Windows Server 2003 e Windows XP: Le stringhe localizzate non sono supportate fino a Windows Vista.
Commenti
Una descrizione di NULL indica che non esiste alcuna descrizione del servizio. La descrizione del servizio è NULL al momento della creazione del servizio.
La descrizione è semplicemente un commento che spiega lo scopo del servizio. Ad esempio, per il servizio DHCP, è possibile usare la descrizione "Fornisce indirizzi Internet per il computer nella rete".
È possibile impostare la descrizione usando la funzione ChangeServiceConfig2 . È possibile recuperare la descrizione usando la funzione QueryServiceConfig2 . La descrizione viene visualizzata anche dallo snap-in Servizi.
Esempio
Per un esempio, vedere Modifica della configurazione di un servizio o query sulla configurazione di un servizio.
Nota
L'intestazione winsvc.h definisce SERVICE_DESCRIPTION come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | winsvc.h (include Windows.h) |