Funzione NPGetCaps (npapi.h)

  • Articolo

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