Funzione NPGetCaps (npapi.h)

Articolo
02/29/2024

Restituisce informazioni sui servizi supportati nella rete.

Sintassi

DWORD NPGetCaps(
       DWORD ndex
);

Parametri

ndex

Valore restituito

La funzione NPGetCaps restituisce una costante o una maschera di bit, a seconda del valore del parametro nIndex . Alcuni dei valori nIndex causano la restituzione di una costante. Nella maggior parte dei casi, tuttavia, il parametro nIndex specifica il set di servizi su cui eseguire la query e il valore restituito è una maschera di bit che indica quali servizi in questo set sono supportati. In questi casi, un valore restituito zero indica che nessuno dei servizi nel set è supportato.

L'elenco seguente mostra i valori che nIndex può contenere, ognuno seguito da una descrizione di ciò che viene restituito per tale valore.

#####WNNC_ADMIN Restituisce una maschera che indica le funzioni amministrative supportate dal provider di rete. Può trattarsi di una o più delle opzioni seguenti.

Contrassegno	Funzione supportata
WNNC_ADM_DIRECTORYNOTIFY	NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE	NPGetDirectoryType

#####WNNC_CONNECTION Restituisce una maschera che indica quale delle funzioni di connessione supporta il provider di rete. Può trattarsi di una o più delle opzioni seguenti.

Contrassegno	Funzione supportata
WNNC_CON_ADDCONECTION (0x00000001)	NPAddConnection
WNNC_CON_CANCELCONNECTION (0x00000002)	NPCancelConnection
WNNC_CON_GETCONNECTIONS (0x00000004)	NPGetConnection
WNNC_CON_ADDCONECTION3 (0x00000008)	NPAddConnection3
WNNC_CON_GETPERFORMANCE (0x00000040)	NPGetConnectionPerformance
WNNC_CON_DEFER (0x00000080)	Le connessioni posticipate sono supportate con NPAddConnection3.

#####WNNC_DIALOG Restituisce una maschera che indica quale delle funzioni della finestra di dialogo supporta il provider di rete. Può trattarsi di una o più delle opzioni seguenti.

Contrassegno	Funzione supportata
WNNC_DLG_DEVICEMODE	NPDeviceMode
WNNC_DLG_FORMATNETNAME	NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION	NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT	NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR	Questo flag non viene usato.
WNNC_DLG_PROPERTYDIALOG	NPPropertyDialog e NPGetPropertyText
WNNC_DLG_SEARCHDIALOG	NPSearchDialog

#####WNNC_ENUMERATION

Restituisce una maschera che indica quali ambiti di enumerazione, se presenti, sono supportati. Per altre informazioni sugli ambiti di enumerazione, vedere la sezione Parameters nell'argomento di riferimento NPOpenEnum. Può trattarsi di una o più delle opzioni seguenti.

Contrassegno	Tipo di enumerazione supportato
WNNC_ENUM_GLOBAL (0x00000001)	NPOpenEnum viene implementato e supporta un ambito di tutte le risorse nella rete. In altre parole, NPOpenEnum supporta RESOURCE_GLOBALNET.
WNNC_ENUM_LOCAL (0x00000002)	NPOpenEnum viene implementato e supporta un ambito di tutte le risorse attualmente connesse. In altre parole, NPOpenEnum supporta RESOURCE_CONNECTED.
WNNC_ENUM_CONTEXT (0x00000004)	NPOpenEnum viene implementato e supporta un ambito di tutte le risorse associate al contesto di rete corrente e predefinito dell'utente. In altre parole, NPOpenEnum supporta RESOURCE_CONTEXT.

Nota Se WNNC_ENUMERATION restituisce una maschera di bit diverso da zero, si sa che il provider di rete supporta NPOpenEnum e può dedurre che il provider supporta anche NPEnumResource e NPCloseEnum. Ciò è dovuto al fatto che un provider di rete che supporta NPOpenEnum supporta anche NPEnumResource e NPCloseEnum.

#####WNNC_NET_TYPE Restituisce un valore che indica il tipo di rete supportato dal provider di rete. La parola alta contiene il tipo di provider e la parola bassa può contenere un sottotipo. Gli sviluppatori che lavorano su nuovi provider devono ottenere un nuovo tipo di rete da Microsoft. Un provider che non restituisce il tipo di rete corretto può causare il comportamento delle funzioni WNET in modi imprevedibili.

Il tipo di rete può essere uno dei seguenti.

WNNC_NET_10NET
WNNC_NET_INTERGRAPH
WNNC_NET_3IN1
WNNC_NET_LANMAN
WNNC_NET_9TILES
WNNC_NET_LANSTEP
WNNC_NET_APPLETALK
WNNC_NET_LANTASTIC
WNNC_NET_AS400
WNNC_NET_LIFENET
WNNC_NET_BMC
WNNC_NET_LOCUS
WNNC_NET_BWNFS
WNNC_NET_MASFAX
WNNC_NET_CLEARCASE
WNNC_NET_MSNET
WNNC_NET_COGENT
WNNC_NET_NETWARE
WNNC_NET_CSC
WNNC_NET_OBJECT_DIRE
WNNC_NET_DCE
WNNC_NET_PATHWORKS
WNNC_NET_DECOREB
WNNC_NET_POWERLAN
WNNC_NET_DISTENCT
WNNC_NET_PROTSTOR
WNNC_NET_EXTENDNET
WNNC_NET_RDR2SAMPLE
WNNC_NET_FARALLON
WNNC_NET_SHIVA
WNNC_NET_FJ REDIR
WNNC_NET_SUN_PC_NFS
WNNC_NET_FRONTIER
WNNC_NET_SYMFONET
WNNC_NET_FTP_NFS
WNNC_NET_TWINS
WNNC_NET_HOB_NFS
WNNC_NET_VINES
WNNC_NET_IBMAL

####WNNC_SPEC_VERSION Restituisce WNNC_SPEC_VERSION51. Le parole elevate e basse del valore restituito contengono i numeri di versione principali e secondari della specifica DELL'API WNet supportata dalla gestione credenziali.

####WNNC_START Restituisce uno dei valori seguenti per indicare se e quando è probabile che il provider inizi. MpR attende il periodo di timeout più lungo specificato da tutti i provider di rete.

Contrassegno	Ora di inizio
0x0	Indica che il provider non verrà avviato, ad esempio se è disabilitato. MpR non eseguirà nuovamente l'avvio del provider di rete.
Ora	Indica l'ora, in millisecondi, fino all'avvio del provider.
0xffffffff	Indica che il provider non sa quando verrà avviato. Se il provider di rete restituisce questo valore, MPR usa il valore predefinito, 60 secondi.
0x1	Indica che il provider è già stato avviato.

####WNNC_USER Restituisce WNNC_USR_GETUSER se il provider di rete supporta la funzione NPGetUser .

Commenti

Quando viene restituita un'ora di inizio da NPGetCaps, mpR usa questo valore per determinare quando provare a avviare di nuovo tutti i provider di rete. MPR usa l'ora di inizio più lunga restituita dai provider denominati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	npapi.h

Vedi anche

NPLogonNotify

NPPasswordChangeNotify

Condividi tramite