---
name: "YGetSoundObjectAttributes"
section: "3"
platform: "linux"
package: "liby-dev"
version: "2.14.5-7"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/YGetSoundObjectAttributes"
---

# YGetSoundObjectAttributes(3)

Sound object attributes

## NAME

YGetSoundObjectAttributes - Sound object attributes

## SYNTAX

\#include \<Y2/Y.h\>\
 \#include \<Y2/Ylib.h\>

int YGetSoundObjectAttributes(\
\
         YConnection \**connection*,\
\
         const char \**path*,\
\
         YEventSoundObjectAttributes \**buf*\
 )

## ARGUMENTS

- *connection*

  Specifies the connection to the Y server, obtained by a call to YOpenConnection.

- *path*

  Specifies the path (in UNIX path notation) to the sound object on the VFS (virtual file system) of the machine that the Y server is running on. If the path is not absolute, then a set of search paths defined on the Y server will be searched through.

- *buf*

  Specifies the pointer to the buffer  to put the sound object attrbiutes in. See YEventSoundObjectAttributes for more information about this structure.

## DESCRIPTION

The YGetSoundObjectAttributes function fetches the attributes for the sound object specified by path and stores the values in the buffer pointer to by buf.

## RETURN VALUE

The YGetSoundObjectAttributes function returns -1 if the sound object does not exist/is not accessible or 0 on success.

## EXAMPLE

\#include \<stdio.h\>\
 \#include \<Y2/Y.h\>\
 \#include \<Y2/Ylib.h\>

int main(int argc, char \*argv\[\])\
 {\
\
         YEventSoundObjectAttributes buf;\
\
         YConnection \*con = YOpenConnection(\
\
                 "/usr/sbin/starty",\
\
                 "127.0.0.1:9433"\
\
         );\
\
         if(con == NULL)\
\
                 [return(1)](/return/1.md);

        if(YGetSoundObjectAttributes(\
\
                 con, "/usr/share/sounds/info.wav", &buf\
\
         ))\
\
                 printf("Failed.\\n");\
\
         else\
\
                 printf("Success.\\n");

        YCloseConnection(con, False);

        return(0);\
 }

## SEE ALSO

[YStartPlaySoundObject(3)](/YStartPlaySoundObject/3.md) [YDestroyPlaySoundObject(3)](/YDestroyPlaySoundObject/3.md)