Condividi tramite


struttura SERVICE_DESCRIPTIONA (winsvc.h)

Contiene una descrizione del servizio.

Sintassi

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

Membri

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:

@[ percorso]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: stringhe localizzate non sono supportate fino a Windows Vista.

Osservazioni

Una descrizione di null indica che non esiste alcuna descrizione del servizio. La descrizione del servizio è NULL quando viene creato il 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.

Esempi

Per un esempio, vedere Modifica del di configurazione di un servizio o l'esecuzione di 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
intestazione winsvc.h (include Windows.h)

Vedere anche

ChangeServiceConfig2

QueryServiceConfig2