NWGetMediaNameByMediaNum(3nw)


NWGetMediaNameByMediaNum -- returns the identifying name or label for the given media object

Synopsis

   #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);

Description

The parameters are as follows:

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

0x0000
SUCCESSFUL

0x897E
NCP_BOUNDARY_CHECK_FAILED

Notices

To call NWGetMediaNameByMediaNum, you must have console operator rights.

Services

File Server Environment

NCP calls

0x2222 123 46
Get Media Name By Media Number

References

NWGetLoadedMediaNumList(3nw), NWGetMediaMgrObjInfo(3nw), NWGetMediaMgrObjChildrenList(3nw), NWGetMediaMgrObjList(3nw), NWGetProtocolStkNumsByMediaNum(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.