Funzione GetSharedServiceDirectory (winsvc.h)

  • Articolo

Restituisce un percorso per un percorso del file system per servizio per un servizio e programmi associati a cui leggere e/o scrivere lo stato.

Sintassi

DWORD GetSharedServiceDirectory(
  SC_HANDLE                     ServiceHandle,
  SERVICE_SHARED_DIRECTORY_TYPE DirectoryType,
  PWCHAR                        PathBuffer,
  DWORD                         PathBufferLength,
  DWORD                         *RequiredBufferLength
);

Parametri

ServiceHandle

Handle al servizio. Questo handle viene restituito dalla funzione OpenService .

DirectoryType

Membro dell'enumerazione SERVICE_SHARED_DIRECTORY_TYPE che identifica il tipo di percorso della directory condivisa per servizio da recuperare.

PathBuffer

Buffer allocato dal chiamante in cui verrà copiata la stringa di percorso. Se NULL, la chiamata alla funzione avrà esito negativo con ERROR_INSUFFICIENT_BUFFER e restituirà la lunghezza del buffer necessaria, in WCHARs, in RequiredBufferLength. Se non NULL, la lunghezza del buffer deve essere specificata in PathBufferLength. Il percorso, se scritto, verrà terminato NULL.

PathBufferLength

Lunghezza del buffer fornito in PathBuffer, in unità di WCHARS. Questo argomento viene ignorato se PathBuffer è NULL.

RequiredBufferLength

Questo valore è impostato sulla lunghezza necessaria del buffer in unità di WCHARs. Questa lunghezza include il carattere NULL terminante.

Valore restituito

Restituisce ERROR_SUCCESS quando tutte le operazioni vengono completate correttamente e il percorso dello stato con terminazione NULL viene scritto in PathBuffer. Restituisce ERROR_INSUFFICIENT_BUFFER se PathBuffer non era abbastanza grande per contenere il percorso dello stato o se PathBuffer era NULL. In questo caso la lunghezza del buffer necessaria in WCHAR viene restituita tramite RequiredBufferLength. Se si verifica un altro errore, viene restituito un codice di errore Win32.

Commenti

Per ServiceSharedDirectoryPersistentState, la sicurezza della directory è impostata per fornire solo l'accesso in scrittura all'account di sistema locale, al SID del servizio e agli amministratori locali. Assicurarsi che i SID del servizio siano abilitati per qualsiasi servizio che chiama questa API. Per altre informazioni, vedere SERVICE_SID_INFO.

Per un'API simile che fornisce lo stato del servizio esclusivamente per l'uso dal servizio stesso, vedere GetServiceDirectory.

Tutte le directory dello stato del servizio vengono eliminate dalla gestione controllo del servizio dopo la disinstallazione del servizio.

Requisiti

   
Client minimo supportato Windows 11 (Build 22000)
Server minimo supportato Windows Server 2022 (Build 20348)
Intestazione winsvc.h
Libreria Onecore.lib

Vedi anche

Openservice

GetServiceDirectory

SERVICE_SID_INFO