NWGetMediaNameByMediaNum

Returns the identifying name or label for the given media object.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Server Environment

Syntax

  #include <nwfse.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWGetMediaNameByMediaNum 
    (NWCONN_HANDLE                   conn,  
     nuint32                         mediaNum,  
     pnstr8                          mediaName,  
     NWFSE_MEDIA_NAME_LIST  N_FAR   *fseMediaNameList);
  

Delphi Syntax

  uses calwin32 
   
  Function NWGetMediaNameByMediaNum 
    (conn : NWCONN_HANDLE; 
     mediaNum : nuint32; 
     mediaName : pnstr8; 
     Var fseMediaNameList : NWFSE_MEDIA_NAME_LIST 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
mediaNum
(IN) Specifies the object ID number of the target media object returned by calling either NWGetMediaMgrObjList or NWGetMediaMgrChildrenList.
mediaName
(OUT) Points to the name of the media object specified by mediaNum.
fseMediaNameList
(OUT) Points to NWFSE_MEDIA_NAME_LIST returning information.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x897E

NCP_BOUNDARY_CHECK_FAILED

Remarks

To call NWGetMediaNameByMediaNum, you must have console operator rights.

mediaName requires a buffer at least as large as FSE_MEDIA_NAME_LEN_MAX +1. It can be longer than that if desired.

NCP Calls

See Also

NWGetLoadedMediaNumList, NWGetMediaMgrObjInfo, NWGetMediaMgrObjChildrenList, NWGetMediaMgrObjList, NWGetProtocolStkNumsByMediaNum