Share via

SERVICE_DESCRIPTIONA struttura (winsvc.h)

  • Articolo

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)

Vedi anche

ChangeServiceConfig2

QueryServiceConfig2